deepseek harness

说明

DeepSeek Harness（命令名 dsh）是 DeepSeek 开源的 AI 编程智能体运行框架。口号是 Agent = 模型 + Harness：模型负责思考，harness 赋予它读文件、改代码、跑命令的能力。它启动的是本地 Web 界面——在浏览器里用中文对话即可开发项目，模型走 DeepSeek，国产、便宜、无需境外网络。

官网：https://www.deepseek.com/harness/
源码：https://github.com/deepseek-ai/deepseek-harness
注意：目前是开发者预览版，迭代较快，界面可能与本文略有出入

准备

Windows 10 及以上
Node.js 18 以上（建议 LTS）：https://nodejs.org，国内镜像 https://npmmirror.com/mirrors/node/。安装后在 PowerShell 里 node -v 能显示版本即可
一个 DeepSeek 账号（手机号注册）：https://platform.deepseek.com

获取 API Key

登录 https://platform.deepseek.com，先充值（10 元够本课程使用）
左侧「API Keys」→「创建 API key」，复制以 sk- 开头的密钥并保存好，只显示这一次

安装与启动

不需要单独的安装步骤，npx 会自动完成下载（首次较慢，耐心等待）。先进入你的项目目录再启动，当前目录会自动成为默认工作区：

bash

cd D:\code\my-project
npx @deepseek-ai/dsh web

启动成功后会自动打开浏览器访问 http://127.0.0.1:3080。全程只需这几条：

bash

npx @deepseek-ai/dsh web   # 启动 Web UI（首次自动初始化，无需手动 init）
dsh --help                 # 查看启动器帮助（需先全局安装，见下）
Ctrl+C                     # 回到 PowerShell 按下，停止服务；浏览器标签关掉即可

每次都敲 npx ... 太长？可全局安装一次，以后用短命令：npm install -g @deepseek-ai/dsh，然后 dsh web
headless（单次任务跑完即退出）、sdk/acp（程序接入）等其他启动模式面向开发者自动化，入门用不到，见 CLI 说明

配置模型（首次）

在浏览器页面里操作，不改环境变量：

打开设置 → 模型
在 DeepSeek 卡片中填入你的 API Key（sk- 开头），点保存
立即生效，无需重启

更换其他模型或接入自定义端点，见模型配置指南。

使用

选择工作区：点击「选择工作区」，添加启动 dsh 时所在的项目目录并选中它。选中前输入框不可用
直接说需求：用中文描述任务，例如：
- 帮我看看 index.html 为什么标题没居中
- 把这个页面改成响应式布局
- 总结一下这个项目的结构
审批：Agent 会读写文件、运行命令；按当前权限策略需要确认的操作，会先弹窗问你，确认后才执行

完整说明见官方 Web UI 指南。

项目说明书：AGENTS.md

在项目根目录放一个 AGENTS.md，写清项目结构、约定与禁忌（比如"页面用 UTF-8 编码""不要动 assets 目录"），dsh 会读取它并照此工作；进入子目录时也会读取子目录的 AGENTS.md。

这是跨工具的通用标准，写一份可被各种 AI 工具识别：https://agents.md/

进阶：Skills、MCP、插件

入门用不到，需要时按这些关键词检索：

Skills（技能） — 把某类任务的固定流程打包成技能，Agent 按需加载：skills 子系统说明
MCP — 给 AI 外接工具和数据源（数据库、浏览器、记忆库等）的协议，官方有记忆服务器的配置示例：MCP 指南
插件 — "一切皆插件"是 dsh 的核心架构：模型、工具、界面都能替换扩展，开发自己的插件见插件开发指南

常见问题

首次启动很慢：npx 在下载包。可先 npm config set registry https://registry.npmmirror.com 换国内源，或全局安装
浏览器没自动打开：手动访问 http://127.0.0.1:3080；端口被占用时启动参数加 --port 8080 换端口
费用与用量：在 https://platform.deepseek.com 查看
遇到报错：预览版迭代快，先看 GitHub Discussions 是否已有答案

deepseek harness ​

说明 ​

准备 ​

获取 API Key ​

安装与启动 ​

配置模型（首次） ​

使用 ​

项目说明书：AGENTS.md ​

进阶：Skills、MCP、插件 ​

常见问题 ​